package blueq.util;


/**
 * 工具类，如字符串处理等常用方法
 * 
 * @author 张帆
 */



public class StringUtil {
    /**
     * 
     * @param object
     * @return
     *
     */
    public static String toString(Object object) {
        // 保存字符串的数值
        String strValue = null;
        
        // object不为空时，取出其对应的字符串数值
        if (object != null) {
            strValue = String.valueOf(object);
        }
        
        // 返回字符串数值
        return strValue;
    }
    
    /**
     * 说明：判断字符串是否是<code>null</code>或者是一个空白字符串。
     * 如果是返回<code>true</code>，否则返回<code>false</code>
     * 
     * @param str
     * @return
     */
    public static boolean isNullOrWhitespace(String str) {
        return (str == null || str.trim().equals(""));
    }
    
    /**
     * @see #isNullOrWhitespace(String)
     * 
     * @param str
     * @return
     */
    public static boolean isEmptyStr(String str) {
        return isNullOrWhitespace(str);
    }
    
    /**
     * 如果字符串超长，将截取前面maxLen部分，并添加...省略号
     * 
     * @param str
     * @param maxLen
     * @return
     */
    public static String maxLenString(String str, 
    								  int maxLen) {
        if (str == null) {
            return null;
        }
        return str.length() > maxLen ? str.substring(0, maxLen) + "..." : str;
    }
   
    /**
     * str为<code>null</code>，返回<code>null</code>。
     * str不为<code>null</code>，返回{@link String#trim()}
     *  
     * @param str
     * @return
     */
    public static String trim(String str) {
        if (str == null) {
            return null;
        }
        return str.trim();
    }
    
  
}